Release 10.1A: OpenEdge Getting Started:
New and Revised Features

Progress 4GL reference

This section provides a summary of new and modified Progress 4GL reference entries for Release 10.1A organized within the following categories:

Auditing
Database
Diagnostics
DOM and SAX
Miscellaneous
Object-oriented extensions
ProDataSet (general enhancements)
ProDataSet and temporary table (reading from and writing to XML)
ProDataSet and temporary table parameters
Web Services Out

The following section provides a list of deprecated Progress 4GL language elements:

Deprecated language elements

Auditing

The following new and modified reference entries provide support for application auditing and user authorization auditing:

Statements:
CREATE CLIENT-PRINCIPAL statement
Functions:
AUDIT-ENABLED function
GENERATE-UUID function
GUID function
HEX-DECODE function
HEX-ENCODE function
SET-DB-CLIENT function
SETUSERID function
Handles:
AUDIT-CONTROL system handle
AUDIT-POLICY system handle
Client-principal object handle
SECURITY-POLICY system handle
Attributes:
APPL-CONTEXT-ID attribute
AUDIT-EVENT-CONTEXT attribute
CLIENT-TTY attribute
CLIENT-WORKSTATION attribute
DOMAIN-DESCRIPTION attribute
DOMAIN-NAME attribute
DOMAIN-TYPE attribute
EVENT-GROUP-ID attribute
LOGIN-EXPIRATION-TIMESTAMP attribute
LOGIN-HOST attribute
LOGIN-STATE attribute
ROLES attribute
SEAL-TIMESTAMP attribute
SESSION-ID attribute
STATE-DETAIL attribute
USER-ID attribute
Methods:
AUTHENTICATION-FAILED( ) method
BEGIN-EVENT-GROUP( ) method
CLEAR-APPL-CONTEXT( ) method
ENCRYPT-AUDIT-MAC-KEY( ) method
END-EVENT-GROUP( ) method
EXPORT-PRINCIPAL( ) method
GET-PROPERTY( ) method
IMPORT-PRINCIPAL( ) method
LIST-PROPERTY-NAMES( ) method
LOAD-DOMAINS( ) method
LOCK-REGISTRATION( ) method
LOG-AUDIT-EVENT( ) method
LOGOUT( ) method
REFRESH-AUDIT-POLICY( ) method
REGISTER-DOMAIN( ) method
SEAL( ) method
SET-APPL-CONTEXT( ) method
SET-CLIENT( ) method
SET-PROPERTY( ) method
VALIDATE-SEAL( ) method
Other:
&IF, &THEN, &ELSEIF, &ELSE, and &ENDIF preprocessor directives

Database

The following modified reference entries provide enhanced database support:

New option to create a new instance of a database with a unique database identifier:
CREATE DATABASE statement (NEW-INSTANCE option)
Updated attribute on the SESSION system handle that allows you to add inactive indexes and new fields to an existing table online:
SCHEMA-CHANGE attribute
Update that allows the DBTYPE function to be evaluated at preprocessor time:
DBTYPE function
&IF, &THEN, &ELSEIF, &ELSE, and &ENDIF preprocessor directives

Diagnostics

The following new and modified reference entries provide enhanced logging support:

New log entry type for classes:
LOG-ENTRY-TYPES attribute
New methods on the LOG-MANAGER system handle:
CLEAR-LOG( ) method
CLOSE-LOG( ) method
WRITE-MESSAGE( ) method

DOM and SAX

The following new and modified reference entries provide enhanced DOM and SAX support:

Statements:
CREATE SAX-READER statement
CREATE SAX-WRITER statement
CREATE X-DOCUMENT statement
CREATE X-NODEREF statement
Handles:
SAX-attributes object handle
SAX-reader object handle
SAX-writer object handle
X-document object handle
X-noderef object handle
Attributes:
ENCODING attribute
FORMATTED attribute
FRAGMENT attribute
NONAMESPACE-SCHEMA-LOCATION attribute
SCHEMA-LOCATION attribute
STANDALONE attribute
STRICT attribute
VERSION attribute
WRITE-STATUS attribute
Methods:
ADD-SCHEMA-LOCATION( ) method
DECLARE-NAMESPACE( ) method
END-DOCUMENT( ) method
END-ELEMENT( ) method
INSERT-ATTRIBUTE( ) method
LOAD( ) method
RESET( ) method
SAVE( ) method
SET-OUTPUT-DESTINATION( ) method
START-DOCUMENT( ) method
START-ELEMENT( ) method
WRITE-CDATA( ) method
WRITE-CHARACTERS( ) method
WRITE-COMMENT( ) method
WRITE-DATA-ELEMENT( ) method
WRITE-EMPTY-ELEMENT( ) method
WRITE-ENTITY-REF( ) method
WRITE-EXTERNAL-DTD( ) method
WRITE-FRAGMENT( ) method
WRITE-PROCESSING-INSTRUCTION( ) method

Miscellaneous

The following reference entries were also created or modified:

New WEB-CONTEXT system handle method for BLOB support in WebSpeed:
GET-BINARY-DATA( ) method
New WIDGET-ID attribute provides support for 3rd party GUI testing tools within the OpenEdge GUI client:
CREATE BROWSE statement
CREATE widget statement
DEFINE BROWSE statement
DEFINE BUTTON statement
DEFINE FRAME statement
DEFINE IMAGE statement
DEFINE RECTANGLE statement
FORM statement
Format phrase
Frame phrase
WIDGET-ID attribute (Windows GUI only)

This new attribute applies to the following widgets:

BROWSE widget
BUTTON widget
COMBO-BOX widget
CONTROL-FRAME widget
DIALOG-BOX widget
EDITOR widget
FILL-IN widget
FRAME widget
IMAGE widget
RADIO-SET widget
RECTANGLE widget
SELECTION-LIST widget
SLIDER widget
TEXT widget
TOGGLE-BOX widget
Note: To enable application-defined widget IDs in your OpenEdge GUI application, you must specify the Use Widget ID (-usewidgetid) startup parameter. For more information about this startup parameter, see OpenEdge Deployment: Startup Command and Parameter Reference .

Modified attribute that lets you specify how Progress interprets a quoted character value during assignment into the BUFFER-VALUE attribute for a character BUFFER-FIELD object:
LITERAL-QUESTION attribute
Note: You can use the Literal Question (-literalquestion) startup parameter to change the default value of the LITERAL-QUESTION attribute to TRUE (which would otherwise be FALSE). For more information about this startup parameter, see OpenEdge Deployment: Startup Command and Parameter Reference .

Object-oriented extensions

The following new and modified reference entries provide object-oriented programming support:

Statements:
CLASS statement
COMPILE statement
CONSTRUCTOR statement
DEFINE statements for defining instance data for a class:

For defining variables:

DEFINE VARIABLE statement

For defining objects:

DEFINE BUFFER statement
DEFINE DATASET statement
DEFINE DATA-SOURCE statement
DEFINE QUERY statement
DEFINE TEMP-TABLE statement

For defining static GUI widgets:

DEFINE BROWSE statement
DEFINE BUTTON statement
DEFINE FRAME statement
DEFINE IMAGE statement
DEFINE MENU statement
DEFINE RECTANGLE statement
DEFINE STREAM statement
DEFINE SUB-MENU statement
DEFINE WORK-TABLE statement
DELETE OBJECT statement
DESTRUCTOR statement
DISPLAY statement
FUNCTION statement
INTERFACE statement
MESSAGE statement
METHOD statement
NEW statement
PUT statement
Functions:
CAST function
PROGRAM-NAME function
QUOTER function
STRING function
TYPE-OF function
VALID-OBJECT function
Handles:
Buffer object handle
COMPILER system handle
ProDataSet object handle
Query object handle
SESSION system handle
Attributes:
CLASS-TYPE attribute
FIRST-OBJECT attribute
LAST-OBJECT attribute
MULTI-COMPILE attribute
Methods:
SUPER( ) method
SET-CALLBACK( ) method
Built-in Progress classes:
Progress.Lang.Class class
Progress.Lang.Object class
Other:
Data types (includes new CLASS data type)
SUPER system reference
THIS-OBJECT system reference

For more information about object-oriented programming with the Progress 4GL, see OpenEdge Getting Started: Object-oriented Programming .

ProDataSet (general enhancements)

The following new and modified reference entries provide enhanced ProDataSet support:

Statements:
DEFINE DATA-SOURCE statement
Handles:
Buffer object handle
Data-source object handle
ProDataSet object handle
Query object handle
Temp-table object handle
Attributes:
ATTACHED-PAIRLIST attribute
DATA-SOURCE-COMPLETE-MAP attribute
FILL-MODE attribute (new REPLACE mode option)
FILL-WHERE-STRING attribute
KEYS attribute
NEXT-ROWID attribute
NUM-REFERENCES attribute
QUERY attribute
RESTART-ROWID attribute
Methods:
APPLY-CALLBACK( ) method
ATTACH-DATA-SOURCE( ) method
COPY-DATASET method
COPY-TEMP-TABLE method
FILL() method
GET-CALLBACK-PROC-CONTEXT( ) method
GET-CALLBACK-PROC-NAME( ) method
GET-CHANGES( ) method
MERGE-CHANGES( ) method
MERGE-ROW-CHANGES( ) method
SAVE-ROW-CHANGES( ) method
SET-CALLBACK-PROCEDURE( ) method
Events:
ROW-UPDATE event

ProDataSet and temporary table (reading from and writing to XML)

The following new and modified reference entries provide information about reading and writing ProDataSet and temporary table data and schema to and from XML:

Statements:
DEFINE BUFFER statement
DEFINE DATASET statement
DEFINE TEMP-TABLE statement
Handles:
Buffer object handle
Data-relation object handle
ProDataSet object handle
Temp-table object handle
Attributes:
ENCODING attribute
NAMESPACE-PREFIX attribute
NAMESPACE-URI attribute
NESTED attribute
XML-DATA-TYPE attribute
XML-NODE-TYPE attribute
Methods:
ADD-RELATION( ) method
READ-XML( ) method
READ-XMLSCHEMA( ) method
SAVE( ) method
WRITE-XML( ) method
WRITE-XMLSCHEMA( ) method

ProDataSet and temporary table parameters

The following new and modified reference entries provide information about passing ProDataSet and temporary table parameters to procedures, user-defined functions, and methods within classes by reference and by binding:

Statements:
DEFINE DATASET statement
DEFINE PARAMETER statement
DEFINE TEMP-TABLE statement
FUNCTION statement
RUN statement
Other:
Parameter definition syntax (Describes the syntax for defining parameters of a user-defined function or a method within a class.)
Parameter passing syntax (Describes the syntax for passing parameters to a procedure, a user-defined function, or a method within a class.)

The following new and modified reference entries provide information about specifying the amount of schema information to marshal for temporary table parameters (as independent temporary tables or members of a ProDataSet object):

Attributes:
MIN-SCHEMA-MARSHAL attribute
NO-SCHEMA-MARSHAL attribute
SCHEMA-MARSHAL attribute
Note: See also the new Temp-table Schema Marshal (-ttmarshal) startup parameter in OpenEdge Deployment: Startup Command and Parameter Reference .

Web Services Out

The following modified reference entries provide enhanced Web Services support:

Updated method for true asynchronous networking support:
CONNECT( ) method (Web Service)

Deprecated language elements

The following language elements are supported only for backward compatibility:

Statements:
CHOOSE statement
PUT SCREEN statement
SCROLL statement
Functions:
GATEWAYS function
GO-PENDING function
IS-ATTR-SPACE function
Other:
EDITING phrase in the PROMPT-FOR, SET, and UPDATE statements

For more information, see:

Manual:	OpenEdge Development: Progress 4GL Reference
HTML online help:	4GL Reference